home *** CD-ROM | disk | FTP | other *** search
/ Celestin Apprentice 4 / Apprentice-Release4.iso / Source Code / C / Applications / MacPerl 5.0.3 / MacPerl Source ƒ / MacPerl5 / pod / modpods / FileHandle.pod < prev    next >
Encoding:
Text File  |  1994-12-26  |  1.2 KB  |  47 lines  |  [TEXT/MPS ]
  1. =head1 NAME 
  2.  
  3. FileHandle - supply object methods for filehandles
  4.  
  5. cacheout - keep more files open than the system permits
  6.  
  7. =head1 SYNOPSIS
  8.  
  9.     use FileHandle;
  10.     autoflush STDOUT 1;
  11.  
  12.     cacheout($path);
  13.     print $path @data;
  14.  
  15. =head1 DESCRIPTION
  16.  
  17. See L<perlvar> for complete descriptions of each of the following supported C<FileHandle> 
  18. methods:
  19.  
  20.     print
  21.     autoflush
  22.     output_field_separator
  23.     output_record_separator
  24.     input_record_separator
  25.     input_line_number
  26.     format_page_number
  27.     format_lines_per_page
  28.     format_lines_left
  29.     format_name
  30.     format_top_name
  31.     format_line_break_characters
  32.     format_formfeed
  33.  
  34. The cacheout() function will make sure that there's a filehandle
  35. open for writing available as the pathname you give it.  It automatically
  36. closes and re-opens files if you exceed your system file descriptor maximum.
  37.  
  38. =head1 BUGS
  39.  
  40. F<sys/param.h> lies with its C<NOFILE> define on some systems,
  41. so you may have to set $cacheout::maxopen yourself.
  42.  
  43. Due to backwards compatibility, all filehandles resemble objects
  44. of class C<FileHandle>, or actually classes derived from that class.
  45. They actually aren't.  Which means you can't derive your own 
  46. class from C<FileHandle> and inherit those methods.
  47.